Authentication Service

TpAuthentication

Das Authentifizierungs-Objekt muss bei jeder Abfrage mitgesendet werden, bei der eine Authentifizierung des Benutzers notwendig ist. Dadurch wird sichergestellt, dass der Benutzer die erforderlichen Zugriffsrechte besitzt.

Datatype	Name	Description
String	CustomerToken	Not used at the moment.
String	TpUser	TimePunch Profile of the used Principal
String	TpHashedPwd	Password Hash (build with MD5 Encryption)
String	Identity	Profile Name of the used Identity, or empty, if the identity is equal to the principal. In order to switch the identity, the principal needs administration rights.
String	Culture	Culture that is used for the localization. e.g. "de-DE”

ValidatedAuthenticationDto : TpAuthentication

Diese Klasse wird bei der Anmeldung zurückgeliefert und enthält zusätzlich zu den übergebenen Daten der TpAuthentication Klasse, noch die Permissions und das gefüllte Customer Token.

Datatype	Name	Description
List\<String>	ValidatedPermissions	Permissions of the logged on user.
String	OpenIdProvider	The connected OAuth2/OpenId Provider
Guid	UserId	The unique Id of the TimePunch user

UserProfileDto

Diese Klasse enthält die Basisdaten um ein TimePunch Profil zu identifizieren.

Datatype	Name	Description
Guid	Id	Unique ID of TimePunch Profile
String	SaveAsName	Name of the TimePunch Profile used to show the user.
String	LogonName	By default the logon name is identical to the used windows logon.
String	UserName	First name and last name of the user.
String	Email	Email of the user

UserLogonDto : UserProfileDto

Diese Klasse enthält die Basisdaten von UserProfileDto und zusätzlich erweiterte Informationen um ein TimePunch Profil zu identifizieren.

Datatype	Name	Description
UserRights	Rights	Permission of the user
DateTime?	FirstEntry	Date/Time of the first entry, if the user has an entry, otherwise NULL
DateTime?	LastEntry	Date/Time of the last entry, if the user has an entry, otherwise NULL
Bool	IsUserProfileActive	True, if the user profile is active.
DateTime?	LockedUpTo	Date until that the time entries are locked. NULL, if no time entries are locked at all.
Bool	IsInCoverage	True, if the user profile is in coverage
String	OAuth2Provider	The connected OAuth2 Provider

UserSearchDto : PagingContextDto

Diese Klasse enthält alle Basisdaten von PagingContextDto und definiert ein Filter zum Suchen von TimePunch Profilen.

Datatype	Name	Description
UserFiltering	UserFiltering	Defines if the users are filtered (CurrentUser, AllUser, SelfDefined)
Guid[]	UserIds	If Filter is set to "SelfDefined” than the users will be filtered by the given ids.
String	GenericSearch	Generic search string that search for logon and/or user name.
Bool?	IsUserDeleted	NULL, searches for deleted and active users. True, to search only for deleted users. False, to search only for non-deleted users.
Guid[]	IsNotInGroupIds	List of group Ids where the user may not be a member of
Guid[]	IsInGroupIds	List of group Ids where the user must be a member of
string	LogonName	Searches for the logon name
string	UserCode	Searches for the user code
Bool	ApplyUserCoverage	Applies the coverage for the search

AutoregistrationDto

Diese Klasse enthält Informationen darüber, ob eine automatische Registrierung von neuen Mitarbeitern zulässig ist.

Datatype	Name	Description
Bool	IsAutoregistrationAllowed	Defines whether the auto-registration of new staff members is allowed.
UserRights	DefaultUserRights	Get the user rights of new staff members
Bool	IsAutomaticLicensing	Defines whether new members will get a new license. But only if there are licenses still available.
ProxySettings	ProxySettings	Defines the proxy settings of the server that also applies to the client.
Bool	TryToAuthenticationWithLocalAD	True, if the client shall try to authenticate with local Active Directory settings

ProxySettings

This class contains the proxy information for the clients. The proxy configuration can be set in the client settings.

Datatype	Name	Description
Bool	UseProxy	Indicates if a proxy should be used
Bool	UseProxyAuthentication	Indicates if proxy authentication is required
Bool	BypassProxyOnLocal	Indicates if the proxy should be bypassed for local addresses
String	ProxyUser	The username for proxy authentication
String	ProxyPassword	The password for proxy authentication
String	ProxyServer	The address of the proxy server
Integer	ProxyPort	The port number of the proxy server